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TITLE 

Computer Software Method for Administering Batch Jobs 

BACKGROUND OF THE INVENTION 

5 The present invention is a computer software method for administering batch jobs, and 

more specifically scheduling, initializing, dispatching, and executing batch jobs. Preferably, the 
batch jobs are written as Java applications, and the batch jobs may be located on a local 
computer or distributed across an enterprise-wide computing system. 

A batch job (also referred to as a batch program) is a computer software application (i.e., 
10 program) for performing some repetitive, low priority task that typically requires no direct 
external input (i.e., non-interactive, non-conversational). Common examples of batch jobs 
include report generation (e.g., daily, weekly, monthly reports) and data updating, backup, and 
sorting. Batch job administration is the scheduling, execution, etc. of batch jobs on a computer 
or network with minimal user supervision. 

15 Batch jobs may be written in a variety of computer languages such as Cobol, Natural, 

SQL, C, C+, C++, etc. The choice of the language used to implement the batch job is heavily 
influenced by the resources and information required by the job during execution. For example, 
a batch job producing reports to show activity and modifications of customer information in a 
database likely would be implemented in SQL. Thus, batch jobs are often tightly coupled to the 

20 components and services that process them, thereby making it difficult to reuse the batch job in a 
different domain (i.e., platform) without substantial modification and rewriting. The present 
invention addresses this need for code reuse and platform independence by encapsulating batch 
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jobs and providing a uniform application programming interface (API) for components and 
services processing the jobs. 



SUMMARY OF THE INVENTION 

5 The present invention discloses a method for processing batch jobs, comprising wrapping 

the batch job to create an application programming interface for communication v^ith a batch 
framework, the batch framework comprising a batch dispatcher class, and the batch dispatcher 
class further comprising a method to execute the batch job; and invoking the batch framework 
according to a predetermined schedule. The batch job may reside locally with the batch 
10 framework remotely from the batch framework. In a preferred embodiment, the batch framework 
is invoked by a scheduling service, preferably the AutoSys scheduling service on Unix platform. 
The AutoSys scheduling service further executes a command line parameter, either a Unix shell 
script or a Windows NT batch file. 

DESCRIPTION OF THE DRAWINGS 

15 Figures lA and IB are block diagrams of a preferred embodiment of the invention 

wherein a batch job is executed in a local enviroimient. 

Figures 2A and 2B are block diagrams of a preferred embodiment of the invention 
wherein a batch job is executed in a distributed enviroimient. 

Figures 3 is an object model, also referred to as a class diagram, of the batch framework 
20 of this invention. 
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DETAILED DESCRIPTION OF THE INVENTION 

Referring to Figs lA and 2 A, scheduler 5 is attached to and invokes batch framework 10, 
which in turn is connected to and executes batch job 15. Fig. lA represents a local operating 
environment, wherein scheduler 5, batch framework 10, and batch job 15 are all operating on a 
5 local computer 20. Fig. 2A represents a distributed operating environment, wherein scheduler 5 
and batch framework 10 operate on local computer 20 to call and execute batch job 15 operating 
on remote computer 25. Alternative embodiments not shown include, distributing scheduler 5, 
batch framework 10, and batch job 15 over three separate computers, and distributing scheduler 
5 on a local computer and batch framework 10 and batch job 15 on a remote computer. In either 

10 a local or distributed environment, local computer 20 and remote computer 25 each may be any 
suitable hardware for hosting and executing a computer application, such as a work station, 
personal computer, or server. Furthermore, any suitable operating system may be used on local 
computer 20 and remote computer 25, for example Windows, Windows NT, OS/2, UNIX, etc. 
In the distributed environment of Fig. 2A, local computer 20 can be linked to and communicate 

15 with remote computer 25 according to any suitable distributed computing system, for example a 
local or wide area network communicating via transmission control protocol / internet protocol 
(TCP/IP). 

Batch job 15 may be any application program performing a task that lends itself to batch 
processing, and batch job 15 may be written in any suitable programming language. Batch job 
20 15 has an application programming interface (API) 17, and batch framework 10 communicates 
with batch job 10 though API 17. An API is a language and message format used by an 
application program/component to communicate with another program/component (e.g., an 
operating system or some other system or control program). Preferably, API 17 is a Java 



3 



Sprint IDF 1398 

interface, which is written in the Java programming language available from Sun Microsystems 
Inc., and operates within a Java virtual machine (JVM). 

Preferably, batch framework 10 is a Java framework comprising the classes shown in Fig. 
3. Batch job dispatcher class 100 is the main (i.e., public) entry point into batch framework 10, 
5 this is batch job dispatcher class 100 is the executable that is invoked in order to use the 
fimctionality provided by the framework. As used in object technology, a class defines the 
methods and variables for a particular type of object; all objects of a given class are identical in 
form and behavior but contain different data in their variables. Accessors are the methods on a 
class that provide access to the variables of the class (for example, get and set commands). The 

10 methods and variables comprising each class are shown in Fig. 3, and it will be understood that 
these methods and variabfes may be modified by one skilled in the art without departing from the 
scope of the present invention. i ; : " 

EJB batch job dispatcher 105 is a subclass that extends batch job dispatcher class 100. 
EJB batch job dispatcher 105 extends the fimctionality of batch job dispatcher class 100 in order 

15 to run (i.e., execute) batch jobs located remotely, and specifically remote jobs operating as 
enterprise java beans (EJBs). While use of EJBs to run remote batch jobs is preferred, other 
subclasses could be added to cover running remote jobs other than EJBs. 

Batch job environment 110 is an interface that defines the fimctionality of the 
implementation of a batch job environment object. An interface (also knovm as a message 

20 interface) is a communication surface that determines the signals (e.g., calls) that can pass 
through the surface; in other words, the interface defines which calls an object will respond to. 
That is, the interface defines the base fixnctionality (i.e., methods) that is required for an 
implementation of the interface. Batch job environment implementation class 115 implements 
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batch job environment 110. The implementation of an object consists of a class definition that 
implements the object interface. A batch job environment object, comprising an implementation 
of the batch job environment implementation class 115 upon request by batch job dispatcher 
class 100, contains configuration information (e.g., batch job name and run parameters) for the 
5 batch job. The configuration information is passed to the batch job (either locally or remotely) 
by batch job dispatcher class 100. A batch job environment object implemented from the batch 
job environment class is a serializeable object that can be passed to a remote batch job operating 
as an EJB. 

Batch exception class 120 is a standard error message class corresponding to common 
10 errors (i.e., throv^able exceptions) encountered in implementing the batch framework. In 
carrying out its functions, the batch framework may call other classes or frameworks to provide 
particular functionality. In the preferred embodiment of Fig. 3, batch job dispatcher: class IQO 
calls file log class 125 (for a logging framework) to obtain file logging functionality or batch job 
environment 110 calls application environment class 130 (from an application environment 
15 framework) to obtain environment/configuration functionality. 

Referring generally to Figs. 1 and 2, batch framework 10 accepts the broad batch job 
class (i.e., a Java class name), the specific batch job to be executed (i.e., a method name), and the 
parameters goveming execution of the batch job (i.e., method parameters). The method of the 
class is executed as a batch job with the parameters supplied as arguments and the retum code 
20 form the batch job method is passed back. Thus, batch framework 10 provides a simple and 
consistent command line interface for requesting that a batch job be executed. 

Fig. IB is a preferred embodiment of the local operating environment of Fig. 1 A, wherein 
a standalone java batch job is executed by the batch framework in response to a request from a 
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Unix shell script. Scheduler 10 (Fig. 1 A) is an automated system (i.e., AutoSys 30) provided by 
the operating systems (OS) for the scheduling and management of jobs. AutoSys is the standard 
scheduling service available on Unix operating platforms. At a scheduled time, AutoSys 30 
executes Unix shell script 35 or a Windows NT batch file. Alternatively, scheduler 10 may be 
5 incorporated into batch framework 10, for example by coding a scheduling method into batch job 
dispatcher class 100. 

Unix shell script 35 comprises command line arguments, including the batch job name/class 
(e.g., accounts payable 45) and the specific method (e.g., backup accounts 50) to perform. Thus, 
Unix shell script 35 invokes main method 102 on batch job dispatcher class 100, passing the 

10 command line arguments. The main method, also referred to as a start method, is the entry point 
into the framework that creates an instance of the class. The main method is a static method 
. . i.rather, than a member method, meaning that the main method can . be invoked without 
instantiating the class. Batch job dispatcher class 100 retrieves a batch job environment object 
from batch job environment class 110, optionally using utility frameworks 40 such as an 

15 application environment framework (Fig. 3). The batch job environment is used to register a 
given instance of the batch job dispatcher with a utility framework such as a logging framework 
(Fig. 3). 

Batch job dispatcher class 100 uses the Java Reflection API to find the requested job class 
name (e.g., accounts payable 45) within its own Java virtual machine (JVM), that is local or 
20 standalone JVM 55. xhe Java Reflection API is a feature in the Java programming language that 
allows an executing Java program to examine or "introspect" upon itself, and manipulate intemal 
properties of the program or classes executing within a program. Batch job dispatcher 100 uses 
the Java Reflection API to locate the appropriate method (e.g., backup accounts 50) for the job 
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class and invokes the retrieved method passing the application environment and properties as 
parameters. Batch job 15 accesses utility frameworks 40 as needed to complete processing. 
Batch job 15 passes return code back to batch job dispatcher class 100, which is passed all the 
way back to AutoSys 30. 

5 Fig 2B is a preferred embodiment of the distributed operating environment of Fig. 2A, 

wherein a remotely located enterprise Java bean (EJB) batch job is executed by the batch 
framework in response to a request from a Unix shell script. Scheduler 10 (Fig. 2 A) is an 
automated system (i.e., AutoSys 30) provided by the operating systems (OS) for the scheduling 
and management of jobs. At a scheduled time, AutoSys 30 executes Unix shell script 35 or a 

10 Windows NT batch file. Alternatively, scheduler 10 may be incorporated into batch framework 

10, for example by coding a scheduling method into batch job dispatcher class 100. 
/ . : - Unix shell script 35 comprises command line arguments, including the batch-job 
r name/class (e.g., accounts payable EJB 46) and the specific method (e.g., backup accounts EJB ■ 
51) to perform. Thus, Unix shell script 35 invokes main method 102 on batch job dispatcher 

15 class 100, passing the command line arguments. Batch job dispatcher class 100 retrieves a batch 
job environment object from batch job environment class 110, optionally using utility 
frameworks 40 such as an application environment framework (Fig. 3). The batch job 
environment is used to register a given instance of the batch job dispatcher with a utility 
framework such as a logging framework (Fig. 3). 

20 Batch job dispatcher class 100 uses the Java Reflection API to find and invoke the EJB 

batch job dispatcher class 105 within its own Java virtual machine (JVM), that is local or 
standalone JVM 55. Batch job dispatcher class 105 uses Java Reflection API to locate "run EJB 
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job" method 106 and invokes the retrieved method passing the application environment and 
properties as parameters. 

EJB batch job dispatcher class 105 uses the Java Reflection API to find the requested job 
class name (e.g., accounts payable 46) located on a remote Java virtual machine (JVM), that is 
5 Weblogic JVM 55. EJB batch job dispatcher 105 uses the Java Reflection API to locate the 
appropriate method (e.g., backup accounts EJB 51) for the job class and invokes the retrieved 
method passing the application environment and properties as parameters. Batch job 15 accesses 
utility frameworks 41 as needed to complete processing. Batch job 15 passes return code back 
through EJB batch job dispatcher class 105 and batch job dispatcher class 100 all the way back 
10 to AutoSys 30. 

The batch framework is configured (i.e., initialized) such that it has the necessary system 
properties for the JVM, the location of a master initialization (ini) file, and an application name 
as it appears in the master initialization file. Command-line parameters (e.g., the Unix shell . / 
script) preferably include the name of the batch job's Java class and name of the batch job's 
15 method. Additional parameters required by the batch job's method are placed in a key-value 
table and passed as one parameter to the batch job. The batch job's method should know the 
name of the keys to retrieve from the table. 

Examples 

While the code examples herein are written in the Java programming language, which is 
20 available from Sun Microsystems Inc., it is understood that other suitable programming 
languages may be used as will be readily apparent to one skilled in the art. Furthermore, it 
should be understood that the code examples are in skeleton or outline form, and are not 
necessarily intended to be in complete executable form, provided however that one skilled in the 
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art could easily tailor executable code based upon these examples. The italicized text following 
the double backslashes (i.e., "//") is commentary text. Examples 1-3 are drawn to the preferred 
local environment embodiment of Figs. 1 A and IB, and Examples 4-6 are drawn to the preferred 
distributed environment embodiment of Figs. 2A and 2B. 
5 EXAMPLE 1 

Assume an accounting application group wants to back up their accounts payable 
from 1992 to 1996. The AccountsPayable class needs configuration values from its initialization 
file. "Accounting" is the application name as it appears in the master initialization file, and 
backup Accounts is the name of the method on the AccountsPayable class. The backup Accounts 
10 method expects to receive a Properties data structure holding the key- value pairs for 
"startRange" and "endRange". The resulting upper-half of the shell script would read (case- 
sensitive): 

# User - Application Name found in the master init. file 
APP_NAME_INIT-"Accounting" 

15 # User - Batch Job Class Name 

JOB_NAME="com.sprint.arch.batch.example.accounting.AccountsPayable" 

# User - Batch Job Method Name 
METHOD_NAME="backupAccounts" 

# User - Key=Value parameter list (space separated) 
20 PARAM_LIST="startRange= 1 992 endRange- 1 996" 

# User - Java Class Path for your Batch Job Class. 

BATCH_JOB_CLASS_PATH="/home/bcamp/BJD/lib/app/accounting.jar" 
A sample master initialization file for Example 1 is: 



mmmmmmmm master ini ##mmm##mmmmm# 

Accounting=d:\\data\\batch\\NT\VAccountingApp.ini 
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A sample application initialization file for Example 1 is: 



m#m#mmm#mmmm#m# Logging M#mmmm#Mmmm#mMmmmm#mm 

; for NT, MUST use double 'V to delimit directory names i.e. 'W 

; Batch Framework will be looking for 'logging.defaultLogFile=<your default Log File>' 
logging.defaultLogFile=d:\\data\\batch\\NT\\defaultLog.doc 

; Log file for your application, could be anything (i.e. key ..'<prefix>.<key>=<your app Log File>' 
logging.myLogFile=d:\\data\\batch\\NT\\defaultLog.doc 

########################################################################### 



The following template applies to batch job class written in Java that will be executed in a 
standalone JVM from the batch framework. For each type of job to perform, preferably two 
methods are created. The first method is called by the batch framework, which receives a 
'BatchJobEnvironment' object and a Properties table. This first method parses out any 
parameters from the Properties table, casts the parameters to the appropriate data type (if not- a 
string), and invokes a second batch job method. The first job method should retum an integer^ 
and carmot throw any exceptions. Therefore, all anticipated exceptions should be handled at the 
first or second batch job method. A retum code of '0' should be used when processing is 
successful. All other retum codes from the batch job should be '10' or greater. Sample code is 
as follows: 

public static int <Method Name>( BatchJobEnvironment, Properties ) { 
<Initialize variables needed for the Logging Framework> 
<Initialize local variables> 

<Parse key- value pairs from the Properties into parameter variables> 
<Cast (if necessary) the parameters into the appropriate type> 
<Catch any exceptions that could occur with the typecast> 



EXAMPLE 2 



<Log the error with the Logging Framework> 
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<Set the appropriate return code and return it> 
<If no errors occurred, calls the underlying batch job method passing the required 

parameter variables> 

<Catch the return code and pass it back to the Batch Framework> 

5 } 

The secondary method can receive any required parameters should perform the actual 
job processing. It is free to instantiate other helper classes, call other methods, or to execute all 
the work solely within the secondary method. The second method must retum an integer and 
10 cannot throw exceptions. Sample code is as follows: 

public|private> static int <Method Name>( <Any required job parameters>. .. ) { 

initialize local variables> . 
<Perform batch job w6rk> 
1 5 <Catch any anticipated exceptions> 

<Log the error with the Logging Framework> 

<Set the appropriate retum code and retum it> 
<If no errors occurred, retum the successful retum code> 

} 

20 

EXAMPLE 3 

The following is an example of a class, "AccountsPayable", which has a job method, 
"backupAccounts". The class definition contains constants needed for a logging framework and 
predetermined retum codes. An AccountingException class was created to represent all caught 
25 application exceptions for the accounting package. 
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Class definition: 



10 



20 



25 



package com.sprint.arch.batch.example.accoimting; 

import java.util.Properties; 
import java.util.Date; 

import com.sprint.arch.logging.*; 

import com.sprint.arch.batch.BatchJobEnvironment; 



* This type was created in VisualAge. 

*/ 

public interface AccountsPayableRetumCodes { 
1 5 static final int SUCCESSFUL_RET_C = 0; 

static final int DEFAULT_RET_C =10; 
static final int ATOI_ERR_RET__C = 20; 

static final int INVALID_PARAM_RET_C = 21; 

} 



* This type was created in VisualAge. 
*/ 

package com.sprint.arch.batch.example. accounting; 

import java.util.Properties; 
import java.util.Date; 



import com.sprint.arch.logging.*; 
30 import com.sprint.arch.batch.BatchJobEnvironment; 

/** 

* This type was created in VisualAge. 

*/ 

35 public class AccountsPayable implements AccountsPayableRetumCodes { 

// Retum Code constants have been moved to a new interface 
//AccountsPayableRetumCodes which this class implements. This is 
//per code review suggestions 
40 private static final String USERID = "Accounting"; 

private static final String CLASS_NAME = "AccountsPayable"; 

// Constants for the Logger 

private static final String LOGGING_PREFIX = "logging"; 
45 private static final String MY_LOG_KEY = "myLogFile"; 
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//Logger is created in the backupAccountsIntemal method and it 
//is passed to remaining methods 

/** 

5 * This method was created in VisualAge. 

* @retum int 

* @param appCon com.sprint.arch.batch.BatchJobEnvironment 

* @parampjava.util.Properties 

*/ 

10 public static int backup Accoiints(BatchJobEnvironment batchJobEnv, Properties p) { 

return backupAccountsIntemal( batchJobEnv, p, 

CLASS_NAME , LOGGING_PREFIX , MY_LOG_KEY ); 

} 

15 * This method was created in VisualAge. 

parameters as myLogger and className are passed, this is because 
the same method will be called from ejb.AccountsPayableBean class 

* @retum int 

* @param appCon com.sprint.arch.batch.BatchJobEnvironment 
20 * @param p java.util.Properties 

*/ 

public static int backup Accounts(Object paraml, Object param25 Object paramN, FileLog 
myLogger, String className) { 

// Do any neccessary work 

25 try { ■ ^ 

// Log something if neccessary 

myLogger.logMsg(className + ":backup Accounts session: 

running startRange " + paraml + 

" EndRange " + param2 , LogBase.DEBUG); 
30 myLogger.logMsg(className + ":backup Accounts session: 

completed.", LogBase.DEBUG); 
myLogger.closeLogO; 
//woo hoo! 

return SUCCESSFUL_RET_C; 
35 } catch (LogMsgException e) { 

// Since logging failed, print the stack trace. 

// Note: deciding whether or not to retum a successfully 

//retum code here should be driven 

// by the requirements and logic of your application 
40 //batch job. 

e.printStackTrace(); 

retum DEFAULT_RET_C; 



} 

45 /** 



} 

* This method was created in VisualAge. 
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* @retum int 

* @param appCon com.sprint.arch.batch.BatchJobEnvironment 

* @param pjava.util. Properties 

*/ 

5 public static int backupAccountsIntemal(BatchJobEnvironment 

batchJobEnv, Properties p, String className, String 
loggingPrefix, String myLogKey ) { 

// Needed for my Logger*s logMsg 
10 String method_name ^ "backup Accounts"; 

int retC = DEFAULT_RET_C; 

String myLogFileName = batchJobEnv.getValue(loggingPrefix 
.myLogKey); 
15 FileLog mylogger = null; 

try{ 

// Establish my mylogger 

mylogger - new FileLog(LogBase.DEBUG, LogBase.DEBUG, 
myLogFileName, true); 
20 } catch (java.io.IOException ioe) { 

//Since logging failed, print the stack trace 
ioe.printStackTraceO; 

} 

25 try{ 

// register this session with my logger 
Date todaysDate = new Date( ); 

mylogger.logMsg(todaysDate.toString(), LogBase.DEBUG); 
mylogger.logMsg("Begining " + className + ":backupAccounts 

30 session LogBase.DEBUG); 

} catch (LogMsgException e) { 

//Since logging failed, print the stack trace 
e .printStackTraceO ; 

} 



// Fetch the parameters this method cares about. 
String startRangeString = p.getProperty("startRange"); 
String endRangeString = p.getProperty("endRange"); 



// Cast (if necessary) the parameters into the appropriate type. 
try{ 

if (startRangeString == null && endRangeString == null) { 
return retC; 

45 } 

Integer startRangeInt Integer. valueOf(startRangeString); 
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Integer endRangeInt = Integer.valueOf(endRangeString); 
} catch (NumberFormatException e) { 

// The string could not be converted into an integer. 
// Log the exception and location with the Logger 
5 String message = "Error attempting to convert a String "+ 

"parameter to an integer."; 

try{ 

mylogger.logMsg(message, LogBase. WARNING); 
} catch (LogMsgException e2) { 
10 //Since logging failed, print the stack trace 

e2 .print StackTraceO ; 

} 

return ATOI_ERR_RET_C; 

} 
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// Calls a method with the same name and the relevant parameters, 
return backupAccounts(startRangeString 

endRangeString,null,mylogger,className ); 

} 

20 } 

EXAMPLE 4 

Assume an accounting application group wants to back up their accounts payable from 
1992 to 1996 and that the accounting group chose to implement their AccountsPayable batch job 

25 as an Enterprise Java Bean (EJB). The AccountsPayableEJBObj EJB needs to access the 
initialization framework and "Accounting" is the application name as it appears in the master 
initialization file. The application name, "Accounting", need only appear in the master 
initialization file on the platform where the BatchJobDispatcher executes and does not have to be 
on the platform where the EJB is deployed. (These two platforms are not necessarily the same.) 

30 "AccountsPayableEJBObj" is the application name of the EJB, as defined in the application's 
initializatoin file by the entries with an 'ejb' prefix. The name of the method on the 
AccountsPayableEJBObj EJB is backupAccounts. The backupAccounts method expects to 
receive a Properties data structure holding the key-value pairs for "startRange" and "endRange". 
The resulting upper-half of the shell script would look like (case-sensitive): 
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# User - Application Name found in the master init. file 
APP_NAME_INIT="Accounting" 

# User - Batch Job Class Name as found in the with an 'ejb' prefix in the-ini file 
EJB_JOB_NAME="AccountsPayableEJBObj " 

# User - EJB Batch Job Method Name 
EJB_METHOD_NAME="backupAccounts" 

# User - Key=Value parameter list (space separated) 
PARAM_LIST="startRange= 1 992 endRange= 1 996" 



A sample master initialization file for Example 4 is: 

m#mm#mm#m master ini mum#mm##m#m#u## 

Accounting=d:\\data\\batch\\NT\\AccountingApp.ini 



A sample application initialization file for Example 4 is: 

mm#mmmmmmmmum# hjbs mmMmmmmmmmmmmmmuMMmmm 

ejbAccountsPayableEJBObj=com.sprmtarch.batch.example.accounting.ejb.AccountsPayableHome 
; For every EJB above, you must provide its provider url and it's initial context factory. 

;EJB deployed on a WebLogic server 

;AccountsPayableEJBObj.java.naming.factory.initial=weblogic.jndi.TengahInitialContextFactory 
;AccountsPayableEJBObj.java.naming.provider.url=t3://localhost:7001 

;EJB deployed on a Websphere server 
AccountsPayableEJBObj.java.naming.providerurl=IIOP:/// 

AccountsPayableEJBObj.java.naming.factoryinitial=com.ibm.jndi,CosNaming.CNInitialContextFa 
ctory 

########################################################################### 

########################## Logging mmmmmmummmmmummmmmnm 

; for NT, MUST use double 'V to delimit directory names i.e. 'W 

; Batch Framework will be looking for 'logging.defaultLogFile=<your default Log File>' 

logging.defaultLogFile=h:\\batchJob_example\\data\\batch\\NT\\defaultLog.txt 

; Log file for your application, could be anything (i.e. key ..'<prefix>.<key>=<your app Log File>' 

logging.myLogFile=h:\\batchJob_example\\data\\batch\\NT\\defaultLog.txt 



EXAMPLE 5 

The following template applies to any batch job class written in Java that will be 
executed as an Enterprise Java Bean (EJB) in a WebLogic JVM from the batch framework. For 
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each type of job to perform, two methods should be created. The first method is called by the 
batch framework, which receives a 'BatchJobEnvironment' object and a Properties table. The 
method is an instance method, not static. The first method parses out any parameters from the 
Properties table, casts the parameters to the appropriate data type (if not a string), and invokes a 
5 second batch job method. The first job method should retum an integer, and cannot throw any 
exceptions. Therefore, all anticipated exceptions should be handled at the first or second batch 
job method. A retum code of '0' should be used when processing is successful. All other retum 
codes from the batch job should be ' 10' or greater. Sample code is as follows: 

public int <Method Name>( BatchJobEnvironment, Properties ) { 
10 <Initialize variables needed for the Logging Framework> 

<Initialize local variables> 

<Parse key- value pairs from the Properties into parameter variables> ■ 

<Cast (if necessary) the parameters into the appropriate type> 

<Catch any exceptions that could occur with the typecast> 

15 <Log the error with the Logging Frame work> 

<Set the appropriate retum code and retum it> 

<If no errors occurred, called the underlying batch job method passing the parameter 
variables> 

<Catch the retum code and pass it back to the Batch Framework> 

20 } 

The secondary method receives any required parameters and performs the actual job 
processing. It is free to instantiate other helper classes, call other methods, or to execute all the 
work solely within the secondary method. The second method should retum an integer and 
25 cannot throw exceptions. Sample code is as follows: 
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public|private> int <Method Name>( 
<Required job parameters>... ) 

{ 

<Initialize variables needed for the Logging Framework> 
5 <Initialize local variables> 

<Perform batch job work> 
<Catch any anticipated exceptions> 

<Log the error with the Logging Framework> 
<Set the appropriate return code and return it> 
10 <If no errors occurred, return the successful return code> 

} 

EXAMPLE 6 

The following is an example of an EJB remote interface, "AccountsPayableEJBObj," 
15 which has a bean, "AccountsPayableBean," and a job method, "backup Accounts." The class 
definition contains constants needed for a logging framework and predetermined retum codes. 
An AccountingException class was created to represent all caught application exceptions for the 
accounting package. 

Class definition: 

20 package com.sprint.arch.batch.example.accounting.ejb; 

/** 

* This is a Session Bean Class 
*/ 

25 import javax.ejb.*; 

import java.util.Properties; 
import java.util.Date; 

// Arch packages 

30 import com.sprint.arch.logging.*; 

import com.sprint.arch.configuration. * ; 

import com.sprint.arch.batch.BatchJobEnvironment; 
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import com.sprint.arch.applicationenvironment. 

ApplicationEnvironmentManager; 
import com.sprint.arch.batch.example.accounting.*; 



public class AccountsPayableBean implements javax.ejb.SessionBean { 

private javax.ejb.SessionContext mySessionCtx = null; 

// Retum Code constants - not required as it just uses the 
//sprint.arch.batch.example.accounting.AccountsPayable 
//class for its business 
//methods. 

// Constants for the Logger 

private static final String USERID = "Accounting"; 
private static final String CLASS_NAME - 

"AccountsPayableBean"; 
private static final String LOGGING_PREFIX = "logging"; 
private static final String MY_LOG_KEY = "myLogFile"; 

//Logger 

//protected FileLog logger = null; 

/** ... 

* This method v^as created in VisualAge. 

* @retum int 

* @param batchJobEnv com.sprint.arch.batch.BatchJobEnvironment 

* @parampjava.util.Properties 

*/ 

//this method simply calls the AccountsPayable batch job method 
//- modified as per code review suggestions 
public int backupAccounts(BatchJobEnvironment batchJobEnv, 
Properties p) 

{ 

return com.sprint.arch.batch. example.accounting. 

AccoxmtsPayable.backupAccountsIntemal( batchJobEnv, 

p, CLASS_NAME, LOGGING_PREFIX , MY_LOG_KEY ); 

} 

* ejbActivate method comment. 
*/ 

public void ejbActivate() { 

} 

/** 

* ejbCreate method comment. 

*/ 

public void ejbCreateQ { 
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} 

* ejbPassivate method comment. 
*/ 

5 public void ejbPassivate() { 

} 

* ejbRemove method comment. 
*/ 

10 public void ejbRemoveQ { 

} 

* setSessionContext method comment. 

*/ 

15 public void setSessionContext(javax.ejb.SessionContext ctx) { 

mySessionCtx = ctx; 

} 
} 
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